home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / isam120.zip / INSTALL.DOC < prev    next >
Text File  |  1994-07-27  |  3KB  |  76 lines
  1.                  INSTALLATION
  2.  
  3.  
  4. Introduction
  5.  
  6. To Install ISAM Manager, simply insert disk 1 into drive A (or
  7. whatever floppy drive letter you are using), and type the following:
  8.  
  9. A:INSTALL
  10.  
  11. INSTALL will ask you for a drive and directory name to install ISAM
  12. Manager into, which will default to "C:\ISAMMGR". The following
  13. subdirectories off C:\ISAMMGR will also be created:
  14.  
  15. INCLUDE         -       Include files
  16. TUT1            -       Tutorial 1 files
  17. TUT2            -       Tutorial 2 files
  18. TUT3            -       Tutorial 3 files
  19. SOURCE          -       ISAM Manager source code
  20. FSCREEN         -       FScreen Library source code
  21. KEYSRCH         -       KEYSRCH & ADDFILE Example program files
  22.  
  23. You should now add "C:\ISAMMGR" to your DOS PATH statement, as this
  24. directory will contain some important executable files, and
  25. "C:\ISAMMGR\INCLUDE" should be added to your compiler's include file
  26. search path.
  27.  
  28. ISAM Manager is no longer shipped with precompiled libraries, due to
  29. the vast number of C++ compilers, and versions that abound. The
  30. precompiled libraries in previous versions accounted for the majority
  31. of bug reports due to different compiler option settings, different
  32. versions etc.
  33.  
  34. THIS EVALUATION VERSION CONTAINS MANGLED SOURCE CODE, WITH ALL
  35. COMMENTS REMOVED. FULL, UNMANGLED SOURCE CODE IS PROVIDED WHEN
  36. YOU REGISTER. THE MANGLING DOES NOT AFFECT THE FUNCTIONALITY OF
  37. THE CODE, ONLY ITS READABILITY.
  38.  
  39. Instructions for building your own libraries follow in the next
  40. section, but you can use ISAM Manager quite easily without the need to
  41. build any libraries. Simply include all the files from the FSCREEN
  42. directory (if you wish to use the FScreen library for DOS), and all
  43. the files in the SOURCE directory with two exceptions. There are two
  44. files which have different versions for the single user version and
  45. the multi-user version. If you wish to have a single user program, you
  46. should include the files "sidxmgr.cpp" and "sdiskmgr.cpp". For a
  47. multi-user program, include "midxmgr.cpp" and "mdiskmgr.cpp" instead.
  48.  
  49. If you are running under a DOS or Windows environment, you must use
  50. either the Compact or Large memory models (Large is preferable).
  51.  
  52.  
  53. Building Libraries
  54.  
  55. There are many reasons why you may want to build libraries
  56. rather than just including the source files in your project. It
  57. simplifies your projects, and if you have multiple projects on
  58. different platforms (or memory models), you will need to make a
  59. library to avoid having the object files clash with each other.
  60. The process is fairly straightforward, particularly for those
  61. compilers that allow you to create .lib files from within the
  62. integrated environment.
  63.  
  64. To create a DOS single-user library, simply compile all the files in
  65. the ISAM Manager SOURCE directory, except for "midxmgr.cpp" and
  66. "mdiskmgr.cpp", and all the files in the ISAM Manager FSCREEN
  67. directory, and make a library from them. To create a Windows
  68. single-user library, compile the same files, except for the FSCREEN
  69. directory.
  70.  
  71. For multi-user libraries, you should include "midxmgr.cpp" and
  72. "mdiskmgr.cpp" and exclude "sidxmgr.cpp" and "sdiskmgr.cpp". The
  73. multi-user files are not provided in this evaluation version. You must
  74. register to obtain the multi-user version.
  75.  
  76.